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DOCUMENTATION 


# SOLR AND CONSTELLIO WIDGETS/MODULES 


e Widgets 
o SearchBar 
o Result 
o Searchinformation 
o Table 
o Table Facet Queries 
o Spellcheck 
o AdvancedSearch 
o Menu 
o Slider 
o Suggest 
e Modules 
o Pager 
o Autocomplete 


# CONSTELLIO WIDGETS/MODULES 


e Widgets 
o Collection 
o Capsule 
e Modules 
o Favorite documents and searches 


# SEARCHBAR WIDGET 


A widget displaying a search bar and search options. 


Variables 


e autocomplete: can take 3 values: 
o false(default): no autocomplete. 
o true: autocomplete automaticaly created. 
o AutocomepleteWidget: an autocomplete widget. 
e autocomplete Options: options for the autocomplete widget if autocomplete set to true. Check the code to see the default structure. 
e removeContentButton: if set to true, creates a button which appears when there is text in the search bar in order to remove it and 
execute a request (default: false). 


Methods 


buildWidget: an implementation of the parent class method. 

e beforeRequest: an implementation of the parent class method. 

Note that the Autocomplete widget is also an extension of the Autocomplete plugin from jQuery Ul and so it has all its variables and methods 
too. 
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# RESULT WIDGET 


A widget displaying the search result. 


Variables 


e pagination: can take 3 values 
o false(default): no pagination. 
o true: pagination automaticaly created. 
o PagerWidget: a pager widget. 


Methods 


e buildWidget: an implementation of the parent class method. 
e beforeRequest: an implementation of the parent class method. 
e afterRequest: an implementation of the parent class method. 


# SEARCHINFORMATION WIDGET 


A widget displaying the search informations like the number of document found, the query execution time, ... 


Methods 


e buildWidget: an implementation of the parent class method. 
e beforeRequest: an implementation of the parent class method. 
e afterRequest: an implementation of the parent class method. 


# TABLE WIDGET 


A widget displaying a facet values in a table. 


Variables 


e name: a name for the facet to be displayed. 
e pagination: can take 3 values: 
o false(default): no pagination. 
o true: pagination automaticaly created. 
o PagerWidget: a pager widget. 
e nbElmToDisplay: the number of facets to display (default: 10). 
e sort: can take 3 values 
o occurences(default): sort the facets by the number of occurences. 
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o AtoZ: sort the facets name by alphabetical order. 
o ZtoA: sort the facets name in a reversed akphabetical order. 
e maxDisplay: maximum number of facets (default: 40). 
e checkedOntTop: if set to true, the checked facets will be sorted on the top before the unchecked facets (default: true). 


Methods 


e buildWidget: an implementation of the parent class method. 

e afterRequest: an implementation of the parent class method. 

e update: a method updating the content of the widget. 

e assocTags: a method maping the search query facets result. 

e sortBy: the method sorting the facets, takes the sort mode as parameter. 
e clickHandler: a callback called when a facet is selected or unslected. 


# TABLE FACET QUERIES WIDGET 


A widget displaying facet queries in a table. 


Variables 


e name: a name for the facet to be displayed. 
e field: the field that will be used in the queries 
e queries: the list of queries 
e pagination: can take 3 values: 
o false(default): no pagination. 
o true: pagination automaticaly created. 
o PagerWidget: a pager widget. 
e nbElmToDisplay: the number of facets to display (default: 10). 
e maxDisplay: maximum number of facets (default: 40). 


# SPELLCHECK WIDGET 


A widget spellchecking a query string. (eg: can offer you to correct constellia in constellio) 
Note: this requires enabling a spellchecker component in the searchhandler of Solr (done in the xml config files), whether you use a pure Solr 
or a Constellio Solr. 


Variables 


e question: a string displayed before the correction of the search query (defualt: 'Would you try with: '). 


Methods 


e buildWidget: an implementation of the parent class method. 
e beforeRequest: an implementation of the parent class method. 
e afterRequest: an implementation of the parent class method. 
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# ADVANCEDSEARCH WIDGET 


A widget helping you to build an advanced search form. 


The AdvancedSearch widget is built with 2 other classes: 


AdvancedSearchTable: which is a part of the advanced search form, containing fields. 
AdvancedSearchField: which are the different fields provided by the advanced search. 


Variables 


tables: an array containing all the tables. 


resizable: if set to true, display a resize bar on the bottom of the advanced search form. Requires jQuery UI Resizable plugin. 


options: options given to the jQuery UI Resizable plugin. 
optionsExtend: if set to true, extends the default parameters defined in this widget (default: true). 


Methods 


buildWidget: an implementation of the parent class method. 
beforeRequest: an implementation of the parent class method. 
addTable: add the AdvancedSearchTable object given in parameter to the table array. 


AdvancedSearchTable 


Variables 


parent: the advancedSearch DOM element. 

elm: the AdvancedSearchTable DOM element itself. 

title: a name for the table. 

description: a description for the table. 

fieldStore: an array containing the AdvancedSearchField fields related to the table. 
manager: a reference to the widget's manager. 


Methods 


init: an init method. 
addField: a method adding an AdvancedSearchField field to the fieldStore array. 


AdvancedSearchField 


Variables 


parent: the advancedSearchTable DOM element. 
elm: the AdvancedSearchField DOM element itself. 
label: a name for the field. 
range: if set to true, will create two inputs instead of one (default: false). 
description: a description for the field. 
multilnput: if set to true, will add a link which allows the user to add more inputs for this field (default: false). 
addInputLabel: text to append to the link adding inputs (default: "Add input"). 
autocomplete: can take 3 values: 

o false(default): no autocomplete. 

o true: autocomplete automaticaly created. 

o AutocomepleteWidget: an autocomplete widget. 


autocomplete Options: options for the autocomplete widget if autocomplete set to true. Check the code to see the default structure. 


manager: a reference to the widget's manager. 
filter: if set to true, the widget will add the content of the field to a fq parameter instead of appending it to the q parameter. 
field: the field in the search engine index this AdvancedSearchField refers to. 
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Methods 


e init: an init method. 
e getValue: a method returning the value of this field. 


# MENU WIDGET 


A widget building a dropdown menu. 


Variables 


e name: the parent element text to display. 
e menultems: a collection of the elements to add to the menu ( {name: ..., link: ...}). 


Methods 


e buildWidget: an implementation of the parent class method. 


# SLIDER WIDGET 


A widget building a slider widget, helping you with selecting a values as range or min/max, ... 


This widget is an extension of the jQuery Ul Slider plugin and also has all its parameters and methods. 


Methods 


e buildWidget: an implementation of the parent class method. 


# SUGGEST WIDGET 


A widget creating a result widget that proposes other suggested documents to your search query. The name may be misleading, this is not the 
suggest module for an autocomplete, it is rather for a "more like this" behavior. 


Variables 


e boots: a list of boosts to apply. { field1: boost_value1, field2: boost_value2, ... }. 
e resultWidget: the result widget which will contain the suggestions, internal use. 


Methods 
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init: an implementation of the parent class method. 
buildWidget: an implementation of the parent class method. 
afterRequest: an implementation of the parent class method. 


# PAGER MODULE 


A module creating a pagination. 


Variables 


source: the source elements to apply the pagination on. Optional if the elements are retrieved by an Ajax request. 
prevLabel: the content of the previous nav button (default: <). 

nextLabel: the content of the next nav button (default: >). 

firstLabel: the content of the first nav button (default: <<). 

lastLabel: the content of the last nav button (default: >>). 

nbElmToDisplay: the number of elements to display (default: 10). 

nbPage: the number of pages, internal use. 

nbPage Displayed: the number of pages to display in the navigation bar. 

nbElements: the number of elements in source, internal use. 

fastNavigationAlwaysVisible: if set to true, will always display the navigation button even if they are useless (eg: first and previous 
button when you are on the first page. Default: false). 

display: the css display value of the pagination elements. 

pageSelected: the page actually selected (default: 0). 


Methods 


init: an implementation of the parent class method. 

update Pages: the method updating the navigation bar (eg: elements to display) 

clickHandler: a callback function called when a click on an element of the navigation is detected. 

update List: a method always called when a click on an element of the navigation is detected. This method is empty by default and must 
be implemented if you need it. 


# AUTOCOMPLETE MODULE 


This module creates a list of suggestions when you type in an input field. Note: this requires enabling a suggest component as a 
requesthandler of Solr (done in the xml config files), in case you use a pure Solr. If you are using Constellio, this config is normally already 
activated in its Solr. For Constellio 1.3, it also requires a modification of the web service servlet in order to reach the Constellio autocomplete 
service. Contact us if you need help. 


This module is also an extension of the jQuery Ul Autocomplete plugin and also has all its parameters and methods. 


Variables 


options: options given to the jQuery Ul Autocomplete plugin. 

optionsExtend: if set to true, extends the default parameters defined in this module (default: true). 

render: an empty variable. You can define it a function changing the way an element is rendering in the autocomplete. 

field: if the values retrived must be focused on a specific field of your search engine index. Note that this option will not work with a 
standard 1.3 Constellio. It requires a modification of its web service. This field variable becomes the variable "f" in the generated query to 
the server 
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e openOnFieldFocus: if set to true, executes a request to retrieve data when cursor entering the input field (default: false). 

e valueSelectFormat: a function that format the data selected in the autocomplete results (eg: if you want to put it between double 
quotes). 

e singleValue: if set to true, when a value is choson in the autocomplete result, the actual value in the input field will be replaced by the 
selected one. 

e searchForltSelf: if set to true, also search the term itself (default: false). This means that the list will contain the word currently typed in 
addition to the words which have at least one more letter 


Methods 


e init: an implementation of the parent class method. 


# COLLECTION WIDGET 


A widget displaying your constellio's collections. Obviously, this widget works only for Constellio. Note that this requires that your manager was 
initialised with the array of Constellio collections. See AbstractManager.collections for that. Note also that it requires a modification of the 
Constellio 1.3 web service servlet. Contact us to know what to modify. 


Methods 


e buildWidget: an implementation of the parent class method. 


# CAPSULE WIDGET 


A widget that gives you tips about your search. Does not work for Solr. Note that this only works for Constellio 1.3, with a modified web service 
in order to support the request. 


Methods 


e init: an implementation of the parent class method. 

e buildWidget: an implementation of the parent class method. 

e beforeRe quest: an implementation of the parent class method. 
e afterRequest: an implementation of the parent class method. 


# FAVORITE DOCUMENTS AND SEARCHES 


A module adding the possibility to create a favorite system on your searches and documents. Does not work for Solr. Note that this only works 
for Constellio 1.3, with a modified web service in order to support the request. 


Variables 


e userld: the id of the user manipulating its favorites. This is actually optional if your server is managing the user sessions. 


Methods 
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e beforeRe quest: an implementation of the parent class method. 

e afterRequest: an implementation of the parent class method. 

e removeFavoriteDocument: takes as parameter the id of the favorite document and a callback method. 

e removeFavoriteSearch: takes as parameter the id of the favorite search and a callback method. 

e removeSearchinHistory: takes as parameter the id of the search to remove in the history and a callback method. 

e getFavoriteDocuments: takes as parameter a callback function, the first element to start on and the number of elements to retrieve. 
e getFavoriteSearches: takes as parameter a callback function, the first element to start on and the number of elements to retrieve. 

e getSearchHistory: takes as parameter a callback function, the first element to start on and the number of elements to retrieve. 


Introduction 


Documentation 


Widgets and modules 


Tutorial 


4 Downloads 


Licence 


Copyright ¢ 4 France Labs / Terrplate HTML Little NEKO 
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